SetGroupPathCamSwitch

使用軸組的移動距離來控制觸發數位輸出的開關。當組移動一定的距離後，開關即開啟或關閉，而開關可受組的向前或向後運動控制。

語法

KsCommandStatus SetGroupPathCamSwitch(
     int Index,
     KsCommandStatus MotionCommand,
     int SwitchLength,
     McCamSwitch* Switches,
     int TrackLength,
     McOutput* Outputs,
     McTrack* Tracks,
     DWORD EnableMask
);

參數

Index [in]：軸組索引，索引以零為起點。最多可有 32 個軸組。

MotionCommand [in]：凸輪開關附加的組運動命令的命令狀態。

SwitchLength [in]：在開關陣列的開關數量，每一軌道最多可有八個開關，SwitchLength 範圍為 0 至 24。

Switches [in]：控制開關動作，軌道數量必須依照順序排列。請見 McCamSwitch 結構。

TrackLength [in]：軌道陣列中的軌道數量，輸出與軌道的長度必須一致。例如，有兩個輸出就必須有兩個軌道，TrackLength 的範圍為 1 至 3。

Outputs [in]：選擇對應軌道所控制的數位輸出。請見 McOutput 結構。

Tracks [in]：將補償時間和遲滯添加到軌道上的開關，Switches 中可見 TrackNumber 之定義。請見 McTrack 結構。

EnableMask [in]：啟用不同軌道，此參數為 BOOL 32 位元，當 BOOL 值設為一時將啟動軌道陣列中的相應軌道。

回傳值

返回 KsCommandStatus 結構。

備註

• 此函式與 SetAxisCamSwitch 運作方式相同。
• 每個組運動命令只能附加到一組凸輪開關（最多 24 個開關）。
• 一個軸組最多可以有三個路徑凸輪開關。
• 一組路徑凸輪開關最多可有三個軌道。
• 組路徑凸輪開關可用於以下功能：
• MoveLinearAbsolute
• MoveLinearAdditive
• MoveLinearRelative
• MoveCircularAbsolute
• MoveCircularAdditive
• MoveCircularRelative
• MoveHelicalAbsolute
• MoveHelicalAdditive
• MoveHelicalRelative

不支援其他如 InchGroup 與 JogGroup 之組運動函式。

範例

N/A

使用需求

	RT	Win32
最低支援版本	4.1	4.1
標頭檔	ksmotion.h	ksmotion.h
程式庫	KsApi_Rtss.lib	KsApi.lib

參見

SetAxisCamSwitch